[6.x] Implement AssetTransformers - #18869
Draft
riasvdv wants to merge 13 commits into
Draft
Conversation
# Conflicts: # src/Support/Facades/ImageTransforms.php # tests/Feature/Image/ImageTransformerTest.php
riasvdv
commented
Aug 12, 2026
| 1. the `transformer` value in the transform array | ||
| 2. the transformer selected by the named image transform | ||
| 3. the asset filesystem's default transformer | ||
| 4. Craft's built-in `craft` transformer |
Contributor
Author
There was a problem hiding this comment.
GeneralConfig's default transformer, not just 'craft' (so it can be overridden globally)
riasvdv
commented
Aug 12, 2026
| 'height' => 800, | ||
| 'blur' => 12, | ||
| ]); | ||
| ``` |
Contributor
Author
There was a problem hiding this comment.
$asset->transform('cloudflare')->getUrl($transformData)
asset.transform('cloudflare')->getUrl([
'width' => 1200,
'height' => 800,
'blur' => 12,
]);
class AssetTransform
{
use ForwardsCalls;
public function __construct(
private Asset $asset,
private AssetTransformer $transformer,
) {
}
public function getUrl(TransformData $transformData): string
{
return $this->transformer->getAssetUrl($this->asset, $transformData);
}
public function __call($method, $parameters): mixed
{
$this->forwardCallTo($this->query, $method, $parameters);
return $this;
}
}
riasvdv
commented
Aug 12, 2026
|
|
||
| ## Registering a Transformer | ||
|
|
||
| Register transformers by listening for `AssetTransformersResolving`. |
Contributor
Author
There was a problem hiding this comment.
Laravel Manager driver system instead of event?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Refactors asset transforms around a generic transformer registry. Filesystems can now define a default transformer, individual transform calls and named image transforms can override it, and plugins can register custom asset transformers with their own cache keys, settings UI, and GraphQL arguments.
Craft’s built-in transformer is registered as
craft, supports private/no-URL transform filesystems via signed action URLs, and runtime transform resolution now goes through the newAssetTransformsservice/facade.Legacy image transformer compatibility remains in the Yii adapter layer.
See
docs/asset-transformers.mdfor documentation on usage